FMS Alarms Data Group

The "FMS Alarms" (FmsAlarm) data group is used to send alarm data to FMS. It gets its data from the "Enron Events" (EnrEvents) support data group, which is a hard-coded support data group.

Alarms are identified by field-device register numbers. A register number can resolve to an FMS item for a specific meter run or for the field device (which includes all of its meter runs). Mapping between alarm data group elements and FMS occurs within the alarmItems element of fmsMaps in the device template file. An ordinal may be specified in the device template file to associate an event with a particular run number.

When an alarm occurs, data groups in the device template file are searched for a data group element reference to a register. Next, the fmsMaps element of the device template file is searched for an FMS item reference to that data group element. If no FMS item is found, the alarm is recorded as device specific. Set the omitUnmappedAlarms attribute to "true" to omit unmapped alarms from the "FMS Alarms" data group. See also FMS Alarm Items.

For more information, see the following subsections:

• Example
• Structure and Components
• To Create a Data Group

For more information about working with device template files, see Device Template Files.

Example

Click here to see an example of the data group   <FmsAlarm niceName="FMS Alarms" baseOrd="1" maxCnt="4" omitUnmappedAlarms="false"> <dgElements/> <uccRecvParms> <SDate desc="Start Device Date/Time" required="true"/> <EDate desc="End Device Date/Time" required="true"/> </uccRecvParms> </FmsAlarm>

Structure and Components

Click here to see the structure and components of the data group   <!-- By default, registers that are not mapped to FMS configItems are recorded as device-specific alarms. Set omitUnmappedAlarms to true to override this behavior. -->   <FmsAlarm niceName="FMS Alarms" omitUnmappedAlarms=""> <dgElements/> <uccRecvParms> <UISParameter/> </uccRecvParms> </FmsAlarm>

To Create a Data Group

1. Using a text editor or XML editor, open the device template file to which you want to add data groups.
2. Define a new data group.
   1. Define a dgElements element.
   2. Define a uccRecvParms element in the data group.
   3. Define one or more RecParmName elements.
3. Define any other required data groups.
4. Validate and load your template.